Informática Multimedia 1995 April

home *** CD-ROM | disk | FTP | other *** search

/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / ARCHIVE / ZCE.ZIP / ZCE&ZD.DOC < prev next >

Wrap

Text File | 1991-12-09 | 59.2 KB | 1,805 lines

Zip Comment Editor and Zip Directory =----------------------------------= Users's Guide Version 1.2 December 9, 1991 Copyright (C) 1990, 91, 92 by Michael D. Boling All Rights Reserved COPYRIGHT NOTICE ZCE & ZD Version 1.2 Copyright (c) 1990, 91, 92 by Michael D. Boling, All Rights Reserved. Zip Comment Editor (ZCE) and companion program Zip Directory (ZD) allow editing and viewing of Zip file Comments. ZCE and ZD have been released as shareware. This means the version you have is fully functional. It also means that within 30 days you decide to use ZCE or ZD, you are obligated to pay a licensing fee or stop using them. ZCE and ZD are copyrighted and may be distributed only under the following conditions: No fee of over $10.00 may be charged for distribution. This restriction applies only to physical copies and is not meant to prevent distribution by telecommunication services. All ZCE files must be distributed together in original, unaltered form. This includes ZCE.EXE, ZD.EXE, ZCE&ZD.DOC, WHATSNEW.DOC, ZCE.HLP, ZD.HLP, ZCE.CFG, FILES.LST and REGISTER.TXT. You may use these programs at your own risk. They have been tested by me on my own computer, but I will not assume any responsibility for any problems which ZCE or ZD may cause you. If you do encounter a problem, please let me know about it, and I will do my best to verify and repair the error. LIMITED WARRANTY THE PROGRAMS CONTAINED IN THIS PACKAGE ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK RELATED TO THE QUALITY AND PERFORMANCE OF THE PROGRAMS IS ON YOU. IN THE EVENT THERE IS ANY DEFECT, YOU ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION. SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS WHICH VARY FROM STATE TO STATE. It is expected that if you find ZCE and ZD useful, you must register your copy. Registration entitles you to receive information to remove trailing banners for this and one future version of ZCE and ZD. Table of Contents What are ZCE and ZD? . . . . . . . . . . . . . . 1 ZCE Features . . . . . . . . . . . . . . . . . . 2 ZD Features . . . . . . . . . . . . . . . . . . . 2 Limitations of ZCE and ZD . . . . . . . . . . . . 2 ZCE & ZD System Requirements . . . . . . . . . . 2 ZCE & ZD Document Information . . . . . . . . . . 3 Using ZCE, <Zip Comment Editor> . . . . . . . . . 4 ZCE Command Line Examples . . . . . . . . . . . . 4 ZCE Command line syntax and switches . . . . . . 4 ZCE Command Line Display Options . . . . . . . . 4 Example ZCE Screen . . . . . . . . . . . . . . . 5 ZCE Main Window Editing Keys . . . . . . . . . . 6 ZCE Commands . . . . . . . . . . . . . . . . . . 7 F1 = On Line Help Window Functions . . . . . . . 7 F2 = Re-Read Zip Comments . . . . . . . . . . . . 7 F3 = Save Zip Comments . . . . . . . . . . . . . 7 F4 = New File Specification & Read Comments . . . 8 F5 = Copy Comment from Another File . . . . . . . 8 F6 = Import Zip Comments from a File . . . . . . 9 ZCE Import Configuration File . . . . . . . . . . 9 Import Commands . . . . . . . . . . . . . . . . . 9 Import Field Commands . . . . . . . . . . . . . . 9 Import Configuration Filename & Syntax . . . . . 10 Import Comments Filename . . . . . . . . . . . . 10 Import Starting Comment Column . . . . . . . . . 11 Import [E]dit/[A]uto . . . . . . . . . . . . . . 11 Import Comment Search [T]agged/[A]ll . . . . . . 11 Import Editing Commands . . . . . . . . . . . . . 11 Import Buffer Size . . . . . . . . . . . . . . . 12 MAIN ZCE Commands Continued . . . . . . . . . . . 13 F7 = Volume Label . . . . . . . . . . . . . . . . 13 F8 = Dos Shell . . . . . . . . . . . . . . . . . 13 F9 = Tag/Untag file for Import . . . . . . . . . 13 F10, Pull Down Menu . . . . . . . . . . . . . . . 13 Escape, Exit ZCE . . . . . . . . . . . . . . . . 15 Tab, Restore Comment . . . . . . . . . . . . . . 15 Ctrl+F1, ZCE Status Screen . . . . . . . . . . . 15 Ctrl+F2, Tag Files with Blank Comments . . . . . 15 Ctrl+F3, Write Filenames and Comments . . . . . . 15 Ctrl+F4, Change Filename . . . . . . . . . . . . 16 Ctrl+F5, Change Video Mode . . . . . . . . . . . 16 Ctrl+F9, Tag/Untag All Filenames . . . . . . . . 16 Ctrl+Enter, View Compressed Zip . . . . . . . . . 16 Using ZD, <Zip Directory> . . . . . . . . . . . . 20 ZD Command Line Syntax and Switches . . . . . . . 20 ZD Command Line Display Options . . . . . . . . . 20 ZD Command Line Color Options . . . . . . . . . . 20 ZD Command Line Sorting Options . . . . . . . . . 21 ZD Pause Control Options . . . . . . . . . . . . 21 ZD File Select Mode and Options . . . . . . . . . 21 ACKNOWLEDGEMENTS . . . . . . . . . . . . . . . . 22 Basic Libraries . . . . . . . . . . . . . . . . . 22 Future Versions of ZCE & ZD . . . . . . . . . . . 23 2.0 - What are ZCE and ZD? Page 1 --------------------------------------------------------------------------- 2.0 What are ZCE and ZD? Have you ever looked in a directory or a diskette and wondered what was in those Zip files? I have on many occasions. That's why I created ZCE and ZD. ZCE and companion program ZD allow easy editing and displaying of Zip Comments. Once Comments are added to Zip files, you won't have to unzip them to know what programs are inside. You usually look for the infamous readme.doc file to find out what the programs inside the Zip file do. You go to all that trouble and find out that this is not the Zip file you were looking for anyway. Sound familiar? Very time consuming and nerve racking! So I looked for a way to attach information about the programs inside the Zip file to the Zip file itself. That is when I learned about Zip Comments. Zip Comments allow attaching text to the end of a Zip file. Zip comment text can anything you want. Currently Zip Comments are primarily used by BBS operators to store advertisements about there BBS. You may see this displayed when you unzip a Zip file. So I decided to store information about the programs inside the Zip file in the Zip comment. I did this for awhile but I found adding Zip Comments manually to many files using PKZIP to time consuming. So in October 1990 I started writing Zip Comment Editor. Note: Once Zip Comments are added, some disk cataloging programs extract these Comments and add them to reports. ZD is a directory listing utility with a twist. ZD quickly displays all files and Zip Comments together in the same listing. What are Zip's and what are Zip Comments anyway? PKZIP is a program that reduces all file types of files into compacted binary form and compacts multiple files in one Zip file. This is great for upload/downloading to Bulletin Board Systems. Please find/download or borrow find out about PKZIP. It may be the most widely used program on pc's today. It certainly saves lots of disk space. I encourage you to read the documentation included with PKZIP. The current version of PKZIP is called PKZ110.EXE and may be found on any BBS. It is the most widely used program on pc's today. ZCE and ZD are not for use by BBS SYSOP's to store adds in Zip files, but for everyday users to store important information in Zip Comments. (1)PKZIP and PKUNZIP are registered trademarks of PKWARE Inc. --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual 2.0 - What are ZCE and ZD? Page 2 ZCE & ZD v1.2 Users' Manual --------------------------------------------------------------------------- 2.1 ZCE Features Display and Edit Zip Comments Save Comments into Zip Files On Line Help Re-Read Zip Comments Copy Comment from Another File Import Comments from External File Modify Floppy Volume Label Shell to Dos Tag/Untag Files for Comment Import EGA/VGA 43/50 line support Write List of Filenames and Comments to a File Rename a File Pull Down Menu View Compresses Zip File Contents Uncompress Zip File using PKUNZIP.EXE and Redirect to (2)LIST.COM Extract Single or Tagged files from Current Zip File to Local Directory Delete Single or Tagged files from Current Zip File Import Comments from a FIle Stored Inside a Zip File (2)LIST.COM is copyright by Vernon D. Buerg. 2.2 ZD Features Quickly Display File Names and Zip Comments Display File Date, Time, Size and Zip Comment On Line Help Color Options File Sorting Options EGA/VGA 43/50 Line Support Set an Environment Variable to Selected Filename for use in batch files 2.3 Limitations of ZCE and ZD Current limit is set to 512 files in any one directory. ZCE has been tested with up to 350 Zip Comments. 2.4 ZCE & ZD System Requirements ZCE and ZD have been designed to work properly on the (3)IBM-PC, IBM-XT, IBM-AT, PS/2, and any close compatible. ZCE and ZD require about 256K of ram to execute. ZCE and ZD require PC/MS DOS version 2.1 or later. (*) IBM-PC, IBM-XT, IBM-AT are trademarks of International Business Machines Corporation, Boca Roton, Florida. --------------------------------------------------------------------------- 2.4 - ZCE & ZD System Requirements ZCE & ZD Users' Manual 2.5 - ZCE & ZD Document Information Page 3 --------------------------------------------------------------------------- 2.5 ZCE & ZD Document Information This document has been formatted to 66 lines per page. Document Key: ^ = The Control key, i.e. ^Home = Control + Home. @ = The Alt key, i.e @F4 = Alt + Function key 4 # = The Shift key, i.e. #F1 = Shift + Function key 1 --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual 2.5 - ZCE & ZD Document Information Page 4 ZCE & ZD v1.2 Users' Manual --------------------------------------------------------------------------- 3.0 Using ZCE, <Zip Comment Editor> 3.1 ZCE Command Line Examples ZCE By itself on the command line will search the current directory for *.ZIP and display one screen of filenames and Comments sorted by filename. ZCE FOO* ZCE will search for FOO*.ZIP in the current directory ZCE A: ZCE will search drive a: for *.ZIP ZCE C:\DOS ZCE will search for a directory called DOS. If the directory DOS exists then ZCE will search for C:\DOS\*.ZIP. If the directory does not exist then ZCE will look for the filename of DOS. Once ZCE determines that the input filename specification is legal ZCE will display a window showing the Zip files being searched for Comments. Escape may be pressed to interrupt ZCE while reading Comments. A query box will be displayed to continue reading Zip Comments. Valid responses are: Y/N for Yes or No Arrow keys move highlighted response. Enter selects Left mouse button click on item if a mouse is detected. ZCE will display an error message if the command line arguments are invalid or if there is a problems opening or reading the files found. The error will indicate the problem. 3.2 ZCE Command line syntax and switches Zip Comment Editor Syntax, ZCE <drive:\path\filenames> [/options] Drive must be a Valid Dos Drive, i.e. A: or B: or C: Path must be in Valid Dos syntax, i.e. \dos\ or \wp50\letters\ Filenames may contain Wildcards, i.e. *.ZIP or H? 3.3 ZCE Command Line Display Options /M Force monochrome display /EGA Display 43/50 lines if EGA or VGA detected. /NS Do not restore original dos screen --------------------------------------------------------------------------- 3.3 - ZCE Command Line Display Options ZCE & ZD Users' Manual 3.4 - Example ZCE Screen Page 5 --------------------------------------------------------------------------- /? Display command line switches both / and - may be used for ZCE and ZD command line switches. 3.4 Example ZCE Screen Disk space Volume Label Date | | Version | Time | Drive | Monitor | | | | | | | +-----------------------------------------------------------------------+ |Zip Comment Editor v1.2 10/26/91 5:27pm 14.6M E: QUICKBASIC VGA | +-----------------------------------------------------------------------+ |BACKUP.ZIP |Backup of c:\dos\ 10/24/90 | |TEST100.ZIP |$$$ Zip Comment to Long, Not Found or Zip Corrupted $$$ | |TEST101.ZIP | | |VIDEO.ZIP | | | | | +-----------------------------------------------------------------------+ |F1=Help F2=Read F3=Save F4=Read F5=Copy F6=Import F7=Vol F8=Dos ... | +-----------------------------------------------------------------------+ ZCE will display the names of Zip files being scanned for Comments or an error message if a problem occurs. ZCE will display in color or monochrome and 25, 43 or 50 lines if the appropriate video card is detected. ZCE will automatically tag all files with blank Comments for other functions described later. All Zip files detected will be displayed on the left side with Zip Comments on the right. The comment will have all control characters removed and truncated to 65 characters. If you want to preserve any Zip comment, simply do not edit the comment. ZCE will only write modified Comments. If ZCE had trouble locating the Zip comment, the message, $$$ Zip Comment to Long, Not Found or Zip Corrupted $$$ will be displayed as the comment. Bad Zip file Comments may not be edited or saved. Either the Zip file is corrupted or the Zip comment is very long. ZCE only reads the last 2024 bytes of the file to find the comment. Usually deleting the Zip comment will allow ZCE to read it correctly. Use the -Z command in PKZIP to delete the Zip comment. See ZIPFIX.BAT for an automated way to remove Comments from all Zip files in a directory. If you do this while in the dos shell make sure you execute the re-read Zip Comments command <F2> when you return to ZCE!!! Make sure you have written out all modified Comments first! See Shell command. ZCE will check each file size for any changes and display an error message if a change is detected. A Function key list will be displayed on the bottom line of the screen. --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual 3.4 - Example ZCE Screen Page 6 ZCE & ZD v1.2 Users' Manual --------------------------------------------------------------------------- 3.5 ZCE Main Window Editing Keys Insert Toggles the insert mode and over-type mode Delete Delete character at cursor Backspace Destructive backspace Left Move the cursor to the left Right Move the cursor to the right Up Move cursor to the next comment Down Move the cursor to the previous comment Return Same as Down Arrow Home Move the cursor to the beginning of the field End Move the cursor to the end of the field ^Home Move cursor to the start and erase the field ^End Erase from the cursor to the end of the field ^BackSpace Erase from the cursor to the start of the field @Home Scroll to top comment @End Scroll to bottom comment Tab Restore comment, until up/down move --------------------------------------------------------------------------- 3.5 - ZCE Main Window Editing Keys ZCE & ZD Users' Manual 4.0 - ZCE Commands Page 7 --------------------------------------------------------------------------- 4.0 ZCE Commands 4.1 F1 = On Line Help Window Functions ZCE will search for the file ZCE.HLP in the current directory and all directories in the current dos path. If the help file is not found an error message will be displayed otherwise the help file will be displayed. PgUp Scrolls up one page PgDn Scrolls down one page Up Scrolls up one line Down Scrolls down one line Left Sweeps left 15 characters Right Sweeps right 15 characters Home Go to far left column ^Home Go to top of file Escape Exit Help Mouse: Next Page Click the left mouse button on <PgDn>. Previous Page Click the left mouse button on <PgUp>. Next Line Click left mouse button on the Down Arrow. Previous Line Click left mouse button on the Up Arrow. Move Pointer The position marker in the scroll bar approximates the position within the help file. To move to another relative position, place mouse cursor on scroll bar position marker and press left mouse button. First Page Click left mouse on <^HOME>. Exit Click right mouse button. 4.2 F2 = Re-Read Zip Comments This command causes ZCE to read Comments from Zip files using the current drive, path and file specifications. This command allows you to read a new disk without exiting ZCE. If any Comments have been modified ZCE will warn you to save them or lose all changes. 4.3 F3 = Save Zip Comments This command saves any modified comment to the file from the drive and path it was read from. Any errors encountered will cause ZCE to display an error message of the problem. ZCE verifies all data writes and checks all file sizes for changes before writing. ZCE will not change file dates or times. --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual 4.3 - F3 = Save Zip Comments Page 8 ZCE & ZD v1.2 Users' Manual --------------------------------------------------------------------------- 4.4 F4 = New File Specification & Read Comments An input prompt window will pop up requesting a new file specification. ZCE will then check this entry and give errors if the input could not be parsed or if files could be found. Wildcard characters are accepted. i.e. * or *.Zip or c:\dos\app? are all valid examples. ZCE will display an error if an invalid drive, path or file specification are entered. Pressing escape will cancel this command. The same rules apply here as the command line file specification when starting ZCE. 4.5 F5 = Copy Comment from Another File If more than one file comment is available in the main ZCE window, ZCE will pop up a list of current Comments which may be used for the current file comment. Use the arrow keys and press enter to select. Escape will abort this command. Home/End keys will move highlight bar to the first/last items in the list. If a mouse is detected the mouse pointer will be displayed. Move the mouse pointer to an item and select using the left button. The right mouse button or pressing escape will abort this command. --------------------------------------------------------------------------- 4.5 - F5 = Copy Comment from Another File ZCE & ZD Users' Manual 4.6 - F6 = Import Zip Comments from a File Page 9 --------------------------------------------------------------------------- 4.6 F6 = Import Zip Comments from a File This command searches a file for Zip file Comments. The search routine will use the filenames without extension as the search strings. Filenames like TEST or VIDEO may be found hundreds of times in a single file. It is best to manually add Comments to common filenames. Searching list may consist of ALL or Tagged filenames. There are two different modes to search a file for Comments. Edit mode will search the import file for a match and if found an edit screen window will pop and allow editing of the comment. Auto mode searches as in Edit mode but Comments are automatically extracted using the starting comment column as the left column of the comment. Auto mode only works if the filename and comment are on the same line. If a comment exists and a new comment is found in Edit or Auto mode a pop up window will appear for you to choose one. 4.6.1 ZCE Import Configuration File Example import screen: ┌[ Import Comments from a File ]─────────────────────────────────────────┐ │ │ │ Config File: ZCE.CFG░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │ │ │ │ Comments File: BBS.LOG │ │ │ │ Col: 30 Comment Edit/Auto: E Tagged/All: T Input Buffer: 128 │ │ │ │ │ │ │ └────────────────────────────────────────────────────────────────────────┘ 4.6.2 Import Commands F1 Help F4 Add Filename to Import File List if less than 9. F5 Select Current Import File List F8 Save Settings file F9 Read Settings file F10 Start Import 4.6.3 Import Field Commands PgUp Move to the first field PgDn Move to the last field Up Move up one field Down Move down one field Left Move left one field --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual 4.6 - F6 = Import Zip Comments from a File Page 10 ZCE & ZD v1.2 Users' Manual --------------------------------------------------------------------------- Right Move right one field Home Move to the beginning of the field End Move to the end of the field Insert Toggle between insert and overstrike mode Del Delete the character under the cursor BackSpace Delete the character to the left of the cursor ^Right Move right one word ^Left Move left one word ^End Delete from the cursor to the end of the field Enter Move to the next field Tab Move to the next field #Tab Move to the previous field Escape Abort Import function Mouse: Left Move to position in field Right Abort Import function 4.6.4 Import Configuration Filename & Syntax The file ZCE.CFG contains the default import configuration. ZCE will search the current directory and all directories in the Dos Path for the file ZCE.CFG. If not found an error message will be displayed and default values will be assigned. ZCE.CFG Import configuration file syntax and defaults. start_col=30 edit/auto=E tag/all=T current_comments_file=FOO.BAR comments_file1=C:\DOS\BBS.LOG comments_file2=C:\DOS\BBS.ZIP,TEST.LOG comments_file#=filename.zip,filename comments_file#=filename import_buffer=256 Where # = 1 to 9 only, No Spaces Allowed. Compressed file must have a .ZIP extension and Import file must exist inside of the compressed file. 4.6.5 Import Comments Filename This is the filename of the file containing the Comments for import. This file must be in ascii format. If this filename is entered as a .Zip extension followed by a comma and another filename, ZCE will enter Zip Import mode. In Zip Import mode ZCE will try to uncompress the second file from the first and use the extracted file as the Import file. This may sound complicated but it really isn't. If C:\DOS\BBS.ZIP,TEST.LOG is entered as the Comments File then --------------------------------------------------------------------------- 4.6 - F6 = Import Zip Comments from a File ZCE & ZD Users' Manual 4.6 - F6 = Import Zip Comments from a File Page 11 --------------------------------------------------------------------------- ZCE will create a subdirectory and call PKUNZIP.EXE to uncompress TEST.LOG. If successful the file TEST.LOG will be used as the Comments File. See View Compresses Zip File section for more details. This special option basically allows you to leave your BBS listings in compressed format and have ZCE temporally uncompress a copy to import Comments. NOTE: The only way to add as comma to the Comments file list is to type in a comma on the Comments File line and then press F4. A text editor may also be used to edit ZCE.CFG directly. 4.6.6 Import Starting Comment Column This number should indicate the starting column of the comment inside the Comments file. This option is only used for (A)UTO mode. 4.6.7 Import [E]dit/[A]uto This is the import type. E for EDIT and A for Automatic. ZCE can read single line Comments from a file in AUTOMATIC mode or up to 240 characters into a small line editor in EDIT mode. AUTOMATIC mode searches the Comments file for a line containing the filename portion like DOCS in DOCS.ZIP. This allows the ZCE to find Comments in all type of BBS (Bulletin Board System) file listings. ZCE will use the comment found on the first line that contains the filename string. This may not be the correct comment. Make sure you check the Comments after ZCE is finished. In EDIT mode (default) ZCE will pop up a line editor with three lines of data starting on the line that the filename is located. You can now edit the comment to your liking. Just remember that the finished comment must be no longer than 65 characters long. ZCE will truncate longer Comments. A marker is displayed at column 65 to indicate where truncation will occur. 4.6.8 Import Comment Search [T]agged/[A]ll Importing of Comments may be performed on tagged or all files. ZCE will only search for Comments of tagged files if T is entered. T is the default. This will speed up comment imports. 4.6.9 Import Editing Commands F1 Help Escape Skip the current comment and will keep the current filename on the search list. Enter Accept, Truncates the current comment to 65 characters and removes the filename from the search list. --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual 4.6 - F6 = Import Zip Comments from a File Page 12 ZCE & ZD v1.2 Users' Manual --------------------------------------------------------------------------- F10 Abort, Terminate Import function. ZCE will ask if you really want to Abort. ZCE will still use all previously found Comments even if Abort is selected. Insert Toggle between insert and overstrike mode Del Delete the character under the cursor BackSpace Delete the character to the left of the cursor ^Right Move right one word ^Left Move left one word ^End Delete from the cursor to the end of the field Enter Move to the next field Tab Move to the next field #Tab Move to the previous field Escape Abort Import function Mouse: Left Move to position in field Right Abort Import function 4.6.10 Import Buffer Size The Import buffer size is the number of lines read each time there is a search. This number my be from 32-384. The higher the number the faster ZCE cans search because of less disk activity. If there is not enough memory available ZCE will display an error message. Reducing the number of Zip files or reducing the import buffer size may allow ZCE to perform the import. --------------------------------------------------------------------------- 4.6 - F6 = Import Zip Comments from a File ZCE & ZD Users' Manual 4.7 - F7 = Volume Label Page 13 --------------------------------------------------------------------------- MAIN ZCE Commands Continued 4.7 F7 = Volume Label If the current or selected drive is A: or B: then ZCE will pop up an input window for the new volume label. Only 11 characters will be allowed. ZCE will only allow characters that are valid for volume labels. 4.8 F8 = Dos Shell Spawns another COMMAND.COM leaving ZCE in memory. About 200K is used by ZCE. If the system crashes or is re-booted all editing of Comments will be lost unless saved. The prompt is modified to remind you to type EXIT to return to ZCE. Enter 'EXIT' to Return to ZCE C:\QB\ZCE> If you Shell to Dos and modify a Zip file in any way or delete files from the Zip File inside the View Zip function, the comment location in the file will be altered and ZCE will display an error message. At this point the modified comment can never be saved. Whenever you return to ZCE from the shell always re-read the Zip file Comments using the <F2> key if any Zip files were modified. Make sure you write out any modified Comments first! This will update comment positions to ZCE and allow correct comment update. 4.9 F9 = Tag/Untag file for Import This function will Tag or Untag a file. The Import function allows importing Comments for all or tagged files. 4.10 F10, Pull Down Menu If F10 is pressed in the main ZCE window a pull down menu will appear. The Pull Down Menu uses about 2000 bytes if string space. Pull Down Menu Keys: Down-Arrow Pulls down a window if one is not already down. Otherwise, it moves the highlight bar down one selection within the window. Up-Arrow Moves the selection bar up one item within a window. If a window is not pulled down, this key has no function. Left-Arrow If a window is not pulled down, the selection bar is moved to the next bar item to the left. If a --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual 4.10 - F10, Pull Down Menu Page 14 ZCE & ZD v1.2 Users' Manual --------------------------------------------------------------------------- window is pulled down, the window under the next bar menu item on the left is pulled down. Right-Arrow If a window is not pulled down, the selection bar is moved to the next bar item to the right. If a window is pulled down, the window under the next bar menu item on the right is pulled down. Alt-Highlighted Key If no windows are pulled down, holding down the Alt key while pressing a key highlighted on the menu bar will pull down the window under that item. Highlighted key If a window is pulled down, pressing a highlighted key will select that item in the menu. Escape If a window is pulled down, it will be erased and only the bar menu and the description line will be active. If a window is not pulled down, the pulldown menu will be exited. Enter If a window is not currently pulled down, the window under the highlighted bar menu item will be displayed. If a window is pulled down, the highlighted item within the window will be selected. Mouse Clicking the left button on a bar menu item will pull down the window for that item. Clicking the left button on an item within a window will select that item. Clicking the right button will exit the pull down menu. --------------------------------------------------------------------------- 4.10 - F10, Pull Down Menu ZCE & ZD Users' Manual 4.11 - Escape, Exit ZCE Page 15 --------------------------------------------------------------------------- Pulldown menu contents: File Comment ┌──────────────────────┐ ┌──────────────────────┐ │ Help F1 │ │ Copy F5 │ │ Read F2 │ │ Restore Comment Tab │ │ Save F3 │ └──────────────────────┘ │ New FileSpec F4 │ │ Import F6 │ Tag │ voLume F7 │ ┌──────────────────────┐ │ Dos Shell F8 │ │ Tag cUrrent F9 │ │ Write Ctrl+F3 │ │ Tag All Ctrl+F9 │ │ reName Ctrl+F4 │ │ Tag Empty Ctrl+F2 │ │ View Ctrl+Enter │ └──────────────────────┘ │ eXit Escape │ └──────────────────────┘ Options ┌──────────────────────┐ │ Status Ctrl+F1 │ │ Display Ctrl+F5 │ └──────────────────────┘ 4.11 Escape, Exit ZCE A message will be displayed asking if you would like to exit ZCE. Default is NO. Arrow keys move between No and YES. The enter key will select. Y or N will also select. If you have a mouse the left button may be used to click on the Y or N. 4.12 Tab, Restore Comment This command will restore the current comment only if the cursor is not moved to another comment. i.e. up or down. 4.13 Ctrl+F1, ZCE Status Screen This command will display the internal ZCE variables. This command is mainly used for development of ZCE. I am documenting this just in case you run into it. 4.14 Ctrl+F2, Tag Files with Blank Comments This command will tag all files with blank Comments. 4.15 Ctrl+F3, Write Filenames and Comments This command will write tagged filenames and Comments to a user specified file. A filename input window will pop up requesting the file to write the filenames and comments. If the file exists or if problems occurred while writing the data to the file error messages will be displayed. The output file is formatted with filename and comment on the same --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual4.15 - Ctrl+F3, Write Filenames and Comments Page 16 ZCE & ZD v1.2 Users' Manual --------------------------------------------------------------------------- line as they appear in ZCE. Many programs can use this file to as input into other database's. i.e. BBS file lists. 4.16 Ctrl+F4, Change Filename This command allows you to change the current filename. A pop up input window will appear prompting for new filename. Only characters valid for filenames will be allowed. If successful the filename will be changed. An error message will be displayed if the rename was not successful. 4.17 Ctrl+F5, Change Video Mode This command toggles between 25/43/50 line mode if ZCE detects that your graphics card supports these modes. 4.18 Ctrl+F9, Tag/Untag All Filenames All files will be tagged or untagged unless they have been displayed as bad or unfound. 4.19 Ctrl+Enter, View Compressed Zip If Ctrl+Enter is pressed the current Zip file will be scanned for all files. A Pick List will be displayed of all files found. If a file is selected by pressing enter, a subdirectory named $%ZCE&# will be created under the current directory. An optional environment variable ZCEWORK may be set to a directory and will be used instead of the current directory. This has two benefits. This directory may be a ramdisk or a drive with more space available. i.e. at the command line type the following or add to Autoexec.bat. set ZCEWORK=g:\ If this directory g:\ is a valid dos drive and directory ZCE will create the temporary there. This allows ZCE to use a ramdisk. PKUNZIP.EXE will be called to extract the chosen file, then LIST.COM will be called to display the file. Once LIST is finished, control will be returned to ZCE. Both PKUNZIP.EXE and LIST.COM must be in a directory in the DOS path. ZCE will display errors if the subdirectory and temporary file could not be created or removed and if PKUNZIP.EXE or LIST.COM could not be found in the DOS path. LIST.COM is the most powerful and widely used shareware file listing program available. Please read the LIST documentation for operation details. Look for it on your local BBS. Recursive Zip viewing is not supported. This means that selecting --------------------------------------------------------------------------- 4.19 - Ctrl+Enter, View Compressed Zip ZCE & ZD Users' Manual 4.19 - Ctrl+Enter, View Compressed Zip Page 17 --------------------------------------------------------------------------- a Zip file inside a Zip file will not list a second list but only extract and display the Zip file in binary. When in the Dos Shell there must be enough memory to execute PKZIP, PKUNZIP and LIST programs. Other Zip View Compressed Commands: F1 On Line Help E Extract highlighted file to current directory Ctrl+E Extract tagged files to current directory D Delete highlighted file from current Zip file Ctrl+D Delete tagged files from current Zip file SpaceBar Tag/Untag highlighted file S Sort by [D]ate, [E]xtension, [F]ilename or [P]ath. Press D, E, F or P. Escape aborts the sort function. Right Mouse Tag/Untag current file Left Mouse Exit View Zip --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual 4.19 - Ctrl+Enter, View Compressed Zip Page 18 ZCE & ZD v1.2 Users' Manual --------------------------------------------------------------------------- Example View Compressed Zip file listing: Filename Compressed Size Compression Method / / / / Original Size / Date Time / Path Scroll Bar / / / / / / / / ┌──────────────────────────────────────────────────────────────────┐ │ 25 .BAT 26 26 Sep-30-91 12:21 Stored DOS/ ░ │ 43 .BAT 15 15 Sep-05-91 13:10 Stored DOS/ ▓ │ 50 .BAT 26 26 Sep-05-91 13:10 Stored DOS/ ░ │ A2ZIP .BAT 138 105 Sep-05-91 13:10 Shrunk DOS/ ░ │ ARC2LZH .BAT 287 225 Sep-05-91 13:10 Shrunk DOS/ ░ │ ARC2ZIPA.BAT 564 290 Sep-05-91 13:10 Imploded DOS/ ░ │ ASK .BAT 37 37 Sep-05-91 13:10 Stored DOS/ ░ │ AUTOEXEC.BAT 749 418 Nov-18-91 7:29 Imploded ░ │ BACKUP .BAT 714 356 Jun-26-91 3:00 Imploded FB/ ░ │ BAT .BAT 5 5 Apr-18-91 17:48 Stored XTG/ ░ │ BBSLOG .BAT 62 59 Sep-05-91 13:10 Shrunk DOS/ ░ │ BD-PIF .BAK 416 121 Oct-04-91 13:07 Imploded QEMM/ ░ │ CALC .BAT 60 59 Sep-05-91 13:10 Shrunk DOS/ ░ │ CASE1 .BAT 387 264 Sep-05-91 13:10 Imploded DOS/ ░ │ CLOSED .BAT 57 56 Nov-08-91 7:32 Shrunk DOS/ ░ │ COM .BAT 5 5 Apr-18-91 17:48 Stored XTG/ ░ │ COMSPEC .BAT 146 119 Sep-27-91 7:25 Shrunk DOS/ ░ │ CONF .BAT 24 24 Jul-22-91 9:34 Stored FB/ ░ └──────────────────────────────────────────────────────────────────┘ If the path is to long to fit on the display the original and compressed file sizes will be removed from the display list. ┌──────────────────────────────────────────────────────────────────────┐ │ FOO . Nov-19-91 9:44 Stored QB/ZCE/ ░ │ FOO .BAT Sep-25-91 11:29 Stored QB/RFP/ ▓ │ TEST .BAK Nov-19-91 10:28 Stored QB/ZCE/REALLY/LONG/PATH/LONG/ ░ │ TEST .BAK Oct-26-91 15:58 Imploded QB/ZCE/DOC/ ░ │ TEST .BAS Apr-09-91 7:19 Imploded PBCLON14/ ░ │ TEST .BAS Sep-25-91 14:09 Imploded QB/RFP/ ░ │ TEST .BAT Jun-04-91 14:12 Stored QB/ZCE/TEST/ ░ │ TEST .BAT Oct-26-91 16:17 Shrunk QB/ZCE/ ░ │ TEST .BAT Sep-25-91 7:54 Stored QB/RFP/ ░ │ TEST .BQL Apr-09-91 7:20 Shrunk PBCLON14/ ░ │ TEST .BQL Sep-25-91 11:20 Shrunk QB/RFP/ ░ │ TEST .DEC Sep-25-91 11:19 Imploded QB/RFP/ ░ │ TEST .DOC Oct-18-91 9:38 Shrunk QB/ZCE/ ░ │ TEST .DOC Oct-26-91 15:59 Imploded QB/ZCE/DOC/ ░ │ TEST .EXE Sep-25-91 13:31 Imploded QB/RFP/ ░ │ TEST .EXT Sep-25-91 11:20 Imploded QB/RFP/ ░ │ TEST .LNK Sep-25-91 10:05 Shrunk QB/RFP/ ░ │ TEST .OBJ Sep-25-91 13:31 Imploded QB/RFP/ ░ └──────────────────────────────────────────────────────────────────────┘ View Compressed file commands when ZCE shells to DOS and executes PKZIP, PKUNZIP or LIST. View Zip File, Enter PKUNZIP -O ZIPFILE DIR\FILE --------------------------------------------------------------------------- 4.19 - Ctrl+Enter, View Compressed Zip ZCE & ZD Users' Manual 4.19 - Ctrl+Enter, View Compressed Zip Page 19 --------------------------------------------------------------------------- Where -O overwrites any existing file with the same name. ZIPFILE is the name of the Zip file to be uncompressed by PKUNZIP. DIR is the path stored inside the Zip file. FILE is the name of the file that is uncompressed. LIST DIR\FILE Where DIR defaults to $%ZCE&#. If the ZCEWORK environment variable is set then this will be prepended to the $%ZCE&# directory. i.e LIST K:\WORK\$%ZCE&#\FILE if ZCEWORK is set to K:\WORK. FILE is the name of the file to view and the same as the file unzipped above. Delete File, D PKZIP -D ZIPFILE PATH\FILE Where -D stands for delete file. ZIPFILE is the name of the Zip file the file will be deleted from. PATH is the OPTIONAL path stored inside the Zip file and FILE is the name of the file to be deleted. Extract Tagged Files, Ctrl+E PKUNZIP ZIPFILE @ZCE.$$$ Where ZIPFILE is the name of the Zip file to be uncompressed. ZCE.$$$ is the file created in the local directory containing a list of tagged files to be extracted. Delete Tagged Files, Ctrl+D PKZIP -D ZIPFILE @ZCE.$$$ Where ZIPFILE is the name of the Zip file to be modified. ZCE.$$$ is the file created in the local directory containing a list of files to be deleted. Extract File, E PKUNZIP -O ZIPFILE DIR\FILE Where -O stands for overwrite existing file with same name. ZIPFILE is the name of the Zip file the selected file will be extracted from. PATH is the optional path stored inside the Zip file and FILE is the name of the file to be extracted. --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual 4.19 - Ctrl+Enter, View Compressed Zip Page 20 ZCE & ZD v1.2 Users' Manual --------------------------------------------------------------------------- 5.0 Using ZD, <Zip Directory> 5.1 ZD Command Line Syntax and Switches ZD /? Entering ZD /? will display command help information. ZD /w /sf Display in wide format and sort by filename ZD *.Zip /ega /ss /zc=3 /np Display all files with .Zip extension in 43 or 50 line mode sorted by file size and shows the Zip Comments in cyan on black and does not pause with each screen of text. 5.2 ZD Command Line Display Options /? Display Help Screen /W Wide Format, Shows date, Time and File Size. The Zip comment is displayed on the next line. /NP No Pause for Full Screen /NS No Save and Restore Screen /EGA Display 43/50 Lines if EGA/VGA Detected /M Force Monochrome Display /L Lower Case File Names /VC View Compressed Files The new View Compressed [/VC] option will displays compressed file contents for .ZIP, .ARC, .PAK and .LZH file extensions. 5.3 ZD Command Line Color Options /ZF=# Zip Filename Colors /ZC=# Zip Comment Colors /OF=# Other Filename Colors /TC=# Text Colors /HC=# Header Colors /BG=# Background Color /VC=# View Compressed Colors /A Alternate Color Set The color codes are: 0 Black 2 Green 4 Red 6 Brown 1 Blue 3 Cyan 5 Magenta 7 White Foreground color: Select the color number For high intensity (bright or light), add 8 For Blinking, add 128 --------------------------------------------------------------------------- 5.3 - ZD Command Line Color Options ZCE & ZD Users' Manual 5.4 - ZD Command Line Sorting Options Page 21 --------------------------------------------------------------------------- Example: Blinking, high-intensity cyan is 3+8+128 = 137 Background color: Select the Color Number Multiply it by 16 Add it to the Foreground Color Example: Blinking, high-intensity cyan on blue is 137+(1*16) = 153 5.4 ZD Command Line Sorting Options /SF Sort by Filename /SS Sort by Size /SE Sort by Extension /SD Sort by Date 5.5 ZD Pause Control Options F1 On Line Help B/PgUp Backup Listing One Page N/Home Re-Read disk S Toggle File Select Mode F4 Enter New File Specification U Create Directory, Unzip Selected File and Exit Escape Quit ZD The file ZD.HLP file must be in the current directory or in a directory in the Dos Path. 5.6 ZD File Select Mode and Options File Select mode highlights a file and allows cursor movement of the highlight. IF ENTER is pressed the ZDSELECT environment variable will be set to the name of highlighted file. If escape is pressed while in file select mode then ZDSELECT will not be set or modified. /SEL Turn on File Select Mode when ZD starts /FO Set ZDSELECT to filename without extension /ME Update Master environment. Default is parent. /LE Update Local environment. /DEBUG Shows environment information for file select mode. UNZIP.BAT shows an example application for file select mode. --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual 5.6 - ZD File Select Mode and Options Page 22 ZCE & ZD v1.2 Users' Manual --------------------------------------------------------------------------- 6.0 ACKNOWLEDGEMENTS Special thanks to my wife Lynette for putting up with all the time I spend on these projects. Special Thanks to Phil Katz of PKWARE for releasing the Zip file formats. Without this many utilities like ZCE and ZD could not be possible. 6.1 Basic Libraries Here is a list of the QuickBasic Libraries and programming aids used to create ZCE and ZD. PBCLONE (Pro Bas Clone) by Thomas G. Hanlin III 3544 E. Southern Ave. #104 Mesa, AZ 85204 MicroHelp Muscle 4636 Huntridge Drive Rosewell, Georgia 30075 (404) 552-0565 QB4BAS Version 4.6 by Harold Thomson 7437 Burnway Drive Orlando, Florida 32819 (407) 351-3737 Basic Window Tools Version 8.0 by James P. Morgan 5226 Via Hacienda #115 Orlando, Florida 32809 The QBNews International QuickBasic Electronics Newsletter. By Clearware Computing P.O. Box 507 Sandy Hook, CT 06482 QBNews is available for download from Microhelp BUG BBS (404) 552-0567 or Crescent Software BBS (203) 426-5958. PKware Inc. 7032 Ardara Avenue Glendale, WI 53209 (414) 352-3670 Quick Basic archive file viewer for MS-DOS machines by Dick Dennison, 914-374-3903 24 hrs The Buerg Utilities, LIST.COM Buerg Software 139 White Oak Circle Petaluma, CA 94952 (707) 778-1811 between 10 am and 5 pm Pacific time. DAZZLING screen restore, appeared in QBNews --------------------------------------------------------------------------- 6.1 - Basic Libraries ZCE & ZD Users' Manual 7.0 - Future Versions of ZCE & ZD Page 23 --------------------------------------------------------------------------- Lawrence Stone P.O. Box 5715 Charleston, OR 97420 The latest ZCE and ZD and most of the libraries listed above are available to all registered users from the Vanguard BBS, (408) 988-0288. 7.0 Future Versions of ZCE & ZD Color Configuration Multiple line Comment Editing Improved Documentation Other archive types All mouse & window support Graphics version Windows version Please send more comments and enhancement suggestions!!!! --------------------------------------------------------------------------- ZCE & ZD v1.2 Users' Manual 7.0 - Future Versions of ZCE & ZD ----------------end-of-author's-documentation--------------- Software Library Information: This disk copy provided as a service of Public (software) Library We are not the authors of this program, nor are we associated with the author in any way other than as a distributor of the program in accordance with the author's terms of distribution. Please direct shareware payments and specific questions about this program to the author of the program, whose name appears elsewhere in this documentation. If you have trouble getting in touch with the author, we will do whatever we can to help you with your questions. All programs have been tested and do run. To report problems, please use the form that is in the file PROBLEM.DOC on many of our disks or in other written for- mat with screen printouts, if possible. PsL cannot debug pro- programs over the telephone, though we can answer questions. Disks in the PsL are updated monthly, so if you did not get this disk directly from the PsL, you should be aware that the files in this set may no longer be the current versions. Also, if you got this disk from another vendor and are having prob- lems, be aware that some files may have become corrupted or lost by that vendor. Get a current, working disk from PsL. For a copy of the latest monthly software library newsletter and a list of the 4,000+ disks in the library, call or write Public (software) Library P.O.Box 35705 - F Houston, TX 77235-5705 1-800-2424-PSL MC/Visa/AmEx/Discover Outside of U.S. or in Texas or for general information, Call 1-713-524-6394 PsL also has an outstanding catalog for the Macintosh.